home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Network / Watch / Read Me next >
Text File  |  1990-10-26  |  5KB  |  115 lines

  1. 06/01/90 
  2.  
  3. Description:  Watch is a networking debugging tool for use on a Macintosh on Localtalk or directly on Ethernet.  There is no documentation for Watch nor is it a supported product.  Use it at your own risk.  It is freely distributed but Cayman Systems, Inc. still maintains a copyright on it.  If you have any
  4. bugs to report, please feel free to send email to support@cayman.com or applelink D0523.
  5.  
  6.  
  7. FEATURES:
  8.     Allows collection and decoding of network packets from ethernet or localtalk.
  9.     AppleTalk and TCP/IP packets are decoded into their components.
  10.     Packets can be saved in several forms and recalled later as well as printed.
  11.     Basic traffic analysis tools are provided.
  12.     Full decoding of AppleTalk and TCP/IP packets is performed.
  13.  
  14. USING WATCH:
  15.     Launch the program.
  16.     Select an interface to monitor under the "interfaces" menu. Localtalk is
  17.     always present. An Ethernet card which Watch can use will also be present       if found on the NuBus.  Multiple ethernet cards are supported.
  18.     
  19. NOTE: Watch closes the AppleTalk and ".ENET" ethernet driver before it         
  20. begins. These drivers are *not* reopened when you exit watch. This means if you want to use appletalk you must use the "network" cdev to reselect your network connection or reboot you mac. This is bogus - sorry. It will be fixed in the next release.
  21.     
  22. Once you have selected an interface, press the "start" button. You should see
  23. packets being collected. When you hit the "stop" button, the collected packets
  24. will be displayed.
  25.     
  26. You can "expand" the decoding by selecting "Show Detail" and "Dump Hex" under the "Display" menu. Scrolling around will show the next or previous packets.
  27.     
  28. Packets can be saved or recalled to either a binary or text file. Packets saved to a text file can *not* be recalled.
  29.     
  30.     Decoding:
  31.     ---------
  32. The decoding of packets currently supports AppleTalk and TCP/IP. The "Display" menu controls what level of detail is displayed.
  33.     
  34.     Files:
  35.     ------
  36. Packets can be saved and recalled in binary files.
  37. Packets can be recalled from binary files saved with Apple's "Peek" program
  38. Packets can be saved as "text"
  39.     
  40.     Printing:
  41.     ---------
  42. Packets can be printed to a printer. Note that since the appletalk drivers are closed, you need to do some trickery to print from inside watch. Make sure you stop collection and the use the control panel "network" cdev to select some other network connection and then select back your usual connection. Then, open the chooser, select your printer and print. If you are printing to a local serialprinter (imagewriter) none of this foolishness is required.
  43.     
  44.     
  45.     Performance:
  46.     ------------
  47.     
  48. The basic analysis tools can be used by selecting the "data window" menu item under "performance". Then, the contents of the data window can be selected via the menu.
  49. Packet size, protocols in use and station analysis are provided. These tools are very basic but are helpful.
  50.     
  51.     
  52. CARDS SUPPORTED:
  53.     localtalk on any macintosh
  54.     Apple/3Com Nubus Ethernet card
  55.     GatorCard E/II Ethernet card
  56.     all Asante Ethernet cards
  57.  
  58. Known Bugs:  
  59.     Watch will not work on a Mac IIfx.
  60.     The zone list in Chooser disappears after quitting from Watch when using a GatorCard
  61.  
  62. HISTORY:
  63.  
  64. 1.6.1    Improved decoding of packets
  65.  
  66. 1.5.3
  67.     Improved decoding of packets
  68.  
  69. 1.5.1
  70.     A bug where dragging the thumb all the way to the bottom in the Detail window, caused the display to disappear and the scrollbar to not function, has been fixed.
  71.  
  72. 1.5
  73.     Display filtering - After packets are captured, they can be filtered before displaying on the screen.
  74.     Capture filtering - The idea of capture filtering is to selectively pickup packets from the network, in order to cut down unnecessary packets.
  75.            NOTE - Leading zeros are required for EtherNet address. Address range and formatwere not validated, therefore, any error in the address will have undetermined results.
  76.     Protocol Decoding - AtalkAD decoding, Tunnel packet decoding, and Phase II ZIP decoding.
  77.     File Translation - Watch 1.5 can save captured packets in Sniffer format, it can also read a Sniffer saved file after the file was translate by Apple File Exchange. 
  78.     Multi Window - Summary and Details were in 2 separated windows. Select a packet in the Summary window and open the Detail/Hex window will display the selected packet in decoded form. The display will change if one selected another packet. One can also double click in a packet within the Summary window to open the packet.
  79.  
  80.     Bugs Fixed
  81.     - Phase 2 RTMP decode
  82.     - Phase 2 ZIP decode
  83.     - zone list in Chooser disappeared after quiting from Watch
  84.     - sometimes one can not scroll to the first packet or a blank line will scroll to the top of the screen
  85.  
  86. 1.4.3
  87.  
  88.     Bugs Fixed
  89.     - Macintosh Plus, SE, & SE/30 crash
  90.  
  91.  
  92. 1.4.2
  93.     added printing and saving as text file
  94.     fixed bug reading in peek or watch binary packet files
  95.     added delta time to summary line
  96.  
  97. 1.4.1
  98.     fixed support for GatorCard E/II
  99.     fixed several scrolling bugs
  100.     circular buffer is really used now (will collect for ever)
  101.  
  102. 1.4.0
  103.     fixed lots of scrolling problems
  104.     
  105. 1.3
  106.     basic functionality
  107.     supports localtalk and Apple's Ethernet card
  108.     
  109.  
  110.  
  111. THIS NOTIFICATION DESCRIBES THE GOVERNMENT'S RIGHTSIN TECHNICAL DATA AND COMPUTER SOFTWARE PROVIDED WITH THE EQUIPEMENT DELIVERED.
  112.  
  113. RESTRICTED RIGHTS LEGEND
  114. Use, duplication, or disclosure by the government is subject to restrictions as set forth in subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013.
  115.